\section Files and Programs

This is a complete list of all files and directories required for \grok:
\medskip\cleartabs\settabs \+ mmmmmmmm & mmmmmmmm & mmmmmmmmmmmmmmmm\cr
\+ {\it file}      & {\it location} & {\it contents}\cr
\smallskip\hrule\smallskip
\+ {\tt grok}      & GBIN                & main executable \cr
\+ {\tt grok.hlp}  & GLIB                & ascii help texts \cr
\+ {\tt Manual.ps} & GLIB                & this PostScript manual \cr
\+ {\tt grokdir}   & GLIB                & demo application directory \cr
\+ {\tt .grok}     & {\tt $\sim$\ }      & default form and database directory\cr
\+ {\tt .grokrc}   & {\tt $\sim$/.grok}  & configuration data for \grok \cr
\+ {\tt grok.xpm}  & LIBDIR              & X pixmap icon, optional \cr
\+ {\tt Grok.icon} & {\tt $\sim$/.icons} & full-color icon, SGI systems only \cr
\smallskip\hrule\smallskip\medskip

``GBIN'' stands for the directory specified in the {\tt GBIN} macro in
the Imakefile or Makefile.alt, by default /usr/local/bin. ``GLIB'' is
also in the Imakefile or Makefile.alt, the default is /usr/local/lib.
``LIBDIR'' is provided by imake and depends on the system, and is
typically /usr/lib/X11.

Every \grok\ application consists of one ``form'' file and one or more
``database'' files. The form file describes the card layout and the
data interpretation; they have the extension {\tt .gf}. The name of the
form file without the extension is put into the Database pulldown in the
main window. The default location for form files is the {\tt $\sim$/.grok}
directory.

The form references data files. Normally, they have the same name as
the form file but with the extension {\tt .db}, and are also stored
in the {\tt $\sim$/.grok} directory. If the resulting path references a
directory instead of a file, the contents of this directory is searched.
Every file in this directory also ends in {\tt .db} and becomes a
section that is put into the Section pulldown. If the directory contains
subdirectories, they are searched for more {\tt .db} files recursively.

\grok\ searches for form files in four locations, in the following order:

\medskip\cleartabs\settabs \+ mm & mmmmmmmm \cr
\+ {\bf 1.} & the current directory, \cr
\+ {\bf 2.} & ./grokdir, \cr
\+ {\bf 3.} & $\sim$/.grok, \cr
\+ {\bf 4.} & GLIB/grokdir \cr

All the form files ending with {\tt .gf} found in these directories are
put into the Database pulldown. Form files from different directories
are separated by an etched line. \grok\ attempts to recognize and
eliminate duplicate form files found over two different paths, but puts
duplicate form files that it thinks are in different directories into
the pulldown multiple times. This can be disabled with the preferences
menu.
